home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
ordor125.zip
/
ORDERDOR.DOC
< prev
next >
Wrap
Text File
|
1991-08-03
|
15KB
|
298 lines
▓▒░ OrderDoor ░▒▓
▓▒░ Version 1.25 ░▒▓
August 3, 1991
Premo Mondone
Copyright 1991
PC Solutions of Cleveland BBS
PC Solutions of Cleveland - Cleveland, TN
(615) 476-2874 1200/2400 Baud
Intro:
─────
OrderDoor was written using QuickBasic v4.5 utilizing Todd Miller's Door Source
v3.2 Library. OrderDoor is a simple easy to use door that doubles as two doors
in one. It is an on-line order door for accepting orders using Visa/MasterCard,
etc. AND it doubles as an on-line BBS Subscription Door. OrderDoor was designed
to be somewhat configurable for the SysOp so that he can use any text file that
is 80 characters or less as his "On-Line Catalog" of items available for sale.
The only requirement here is that the text file be simply named "catalog" and
placed in the OrderDoor directory. The Subscription Fee for the BBS is also
configurable via use of the Orderdor.cfg file that will be explained later in
this documentation.
This software is marketed under the "shareware" concept. The shareware version
works exactly like the registered version, except the registered version does
not have the "Please register" message present. The registered version has
instead a nice message saying "Thanks for registering", etc. and even mentions
the SysOp by name. The registration fee is only $10.00 (U.S. Funds) and
entitles you to free upgrades available for download on PC Solutions.
* NEW FEATURES *
The registration fee ALSO entitles you to a copy of a simple utility
(APPROVE.EXE) that will allow you to enter the approval number (ya asked for
this) on each and every transaction. I have now included the report utility
inside the door itself, (you guys asked for it, ya got it!) instead of an
external module that is run from dos. The shareware version only prints some
basic information to the screen and does NOT include all the information
contained in each transaction. In the registered version it gives you the option
of print ALL of the data in the file or only any NEW transactions (ya asked for
this too and ya got it too!) that have occurred since the last time you printed
the report!
This report option is password protected and the password is configurable by the
SysOp, even in the shareware version. Please note that this password option is
CASE SENSITIVE.
*MORE NEW FEATURES*
Now when using the internal report function (to the screen), if you've
already viewed the record, it will not show, therefore you will only be
shown any new records since the last time you used the funtion. Also,
with version 1.25, I added a simple labeling utility to print mailing
labels from the charge.dat file. This is only included with the
registered versions. I also added an OrderDoor Log function. Now,
OrderDoor will maintain a log file of all who enter the Door. The
filename that it creates is Orderdor.log.
* WARNING *: Because of all of the above changes the CHARGE.DAT file has changed
significantly. Delete any old .dat files (after printing a report of course) and
then create a new one. SPECIAL NOTE: The file format has changed
slightly, from v1.24 & v1.25, so you need to delete any old files and
begin fresh with the new format. I have included a sample charge.dat
file that you can start off with. Also, because of the above change, I
made a slight modification to the Approve Module, so be sure and use the
current copy in the registered archive.
I also added a new feature to the main menu. Some of you asked for it to be
configurable, so I came up with a compromise. After the door displays the menu,
it will also now display a simple ascii text file of your named "SPECIAL". This
is where you can include any special instructions to the user. I have included a
sample file so that you can see an example of what I'm talking about. It must be
a pure ascii file and must be 80 columns or less. The sample file that I
included is 3 lines long, it can be longer, but I'd keep it down to 5 or 6 so
that the screen display looks ok. If it looks funny to ya, you may want to knock
a line or two off. WARNING: This file is required! If you fail to
create one or use the sample provided, weird things may happen!
Door Source has many advantages over most Door Libraries for QuickBasic. One
advantage is that the patched Brun45.exe is NOT needed. In addition to the
above it also has the following features:
* Handles comm port by assembly interrupt routines.
* A sysop page routine.
* Support for bauds up to 52,600 bps!
* Properly credits chat time to caller's time left.
* Always checking for a loss of carrier.
* Supports PCBoard 14.x, PCBoard 11.x and 12.x!
* Handles locking ports
One of Door Source's advantages over some of the other door writing utilities is
that Door Source can support several versions of PCBoard! Now with version 3.2
of DoorSource, WildCat, RBBS and BBS Softwarer utilizing DOORSYS are also
supported. The versions of PCBoard are 11.8 and up, including support for 14.0
and up! The default bbs type is PCBoard 14.x. If you wish to change that, simply
put this into your environment table by using the DOS command, SET in your
autoexec.bat file.
SET DORSRC=PCB14 - Door Source will run PCBoard 14.x (DEFAULT)
SET DORSRC=PCB121 - Door Source will run PCBoard 11.8+ with COM1
SET DORSRC=PCB122 - Door Source will run PCBoard 11.8+ with COM2
SET DORSRC=WILDCAT - Door Source will run Wildcat
SET DORSRC=RBBS - Door Source will run in RBBS mode
SET DORSRC=DOORSYS - Door Source will use the DOOR.SYS
Another way to change the setting for the bbs type is on the command line,
simply put PCB121 on the command line for PCBoard 11.8+ on COM1 and PCB122 on
the command line for PCBoard 11.8+ on COM2, like this :
ORDERDOR ORDERDOR.CFG PCB121
For WildCat, and I suspect other systems, you MUST specify the BBS on the
command line that fires up OrderDoor. For example:
ORDERDOR ORDERDOR.CFG WILDCAT
ORDERDOR ORDERDOR.CFG RBBS
ORDERDOR ORDERDOR.CFG DOORSYS
I am not certain on the RBBS or DoorSys BBS's (I have yet to have a BETA tester
from one of these systems verify this), but thanks to Gene Coleman, SysOp of the
Silver Bullet (a WildCat BBS) I am certain that it works and is required for
WildCat systems. You can't specify PCB14 on the command line, instead, Door
Source will default to it. To be safe, I would include the SET command in my
autoexec.bat AND the bbs parameter as shown above in the command line that fires
up OrderDoor.
You can also not specify anything at all, and let Door Source figure out the bbs
type that you are using. But the filename for the information file has to be the
same. Here are the filenames Door Source will look for in the first line of the
configuration file:
PCBOARD.SYS - PCBoard systems
CALLINFO.BBS - WildCat systems
DORINFO1.DEF - RBBS systems
DOOR.SYS - For DOOR.SYS usage
Setup:
─────
Setup for OrderDoor is real simple. The batch file to load the door should be
as follows:
F: <----- Drive containing OrderDoor
cd\doors\orderdor <----- Subdirectory containing OrderDoor
orderdor orderdor.cfg <----- Command Line to load OrderDoor
D: <----- Drive containing PCB directory
cd\pcb <----- Change directory to PCB
board <----- Re-Load PCBoard
The config file for OrderDoor (orderdor.cfg), is as follows:
D:\pcb\pcboard.sys <----- Drive & directory containing pcboard.sys
PC Solutions <----- Name of your BBS
Premo <----- SysOp's first name
Mondone <----- SysOp's last name
15.00 for 3 months <----- BBS Subscription fee #1
25.00 for 6 months <----- BBS Subscription fee #2
50.00 for 1 year <----- BBS Subscription fee #3
100.00 for Lifetime Membership <---- BBS Subscription fee #4
bubba <----- Your password for the SysOp Report Option
Visa <----- Credit Card #1 *NEW in this version.
Mastercard <----- Credit Card #2 " " " "
Discover <----- Credit Card #3 " " " "
American Express <----- Credit Card #4 " " " "
Both files above can be created with any pure ascii editor. If you run a free
BBS (no subscription fee), then you can put $0 in the place reserved for the
subscription fee. Please note that OrderDoor now supports up to four (4)
different BBS Subscription fees. If you only have one subscription fee, you MUST
LEAVE THREE (3) BLANK LINE IN YOUR *.CFG FILE! ALSO, just added to v1.24, lines
10, 11, 12 & 13 are used to display up to four (4) different credit cards that
are accepted by your BBS. If less than four are used, then there MUST be BLANK
LINES left at the end of the config file. I only accept 3 credit cards on PC
Solutions, so in my config file I have lines 10, 11 & 12 filled out with the
last line (line #13) left blank.
There is also a "welcome" screen that is included that can be added to, but the
information already contained in the "welcome" files maynot be deleted or
altered. Feel free however to change colors, etc. as you see fit. There should
be both an ascii version and an ansi version as well.
Other features:
──────────────
OrderDoor while in operation will have the status line on the bottom the screen
on line 24 and line 25. It will show these things:
1. The caller's baud rate
2. The caller's name
3. Time left in the door in minutes.
4. The name of the door and release version number.
5. Door Source 3.2
6. The time the door was entered, current time and flags if any.
7. Graphics mode (GR) or (NGR)
8. Bell/Caller alarm toggle status
The function keys open for the sysop to use are the following:
(F4) Page Bell Toggle
(F7) Caller Alarm Toggle
(F8) Return the user to the bbs
(F10) Start chat with user
(ESC) End chat with user
(ALT-X) Exit to DOS after sign-off toggle
(ALT-N) Sysop on next toggle
That's about it for now. I am open to suggestions on improving OrderDoor. This
is the first version and I'm sure there will be some things that I left out or
forgot. I can be contacted on PC Solutions or the SysOp's Conference of any
member of the LiteLink Mail Network.
HISTORY:
───────
January 26, 1991: Initial v1.0 released.
February 7, 1991: v1.1: Minor Bug fixed in BBS Subscription routine.
March 3, 1991: v1.2: Added User name from Users file to the data file. Also
added a date/time stamp to the data file. Also an ASCII text search module was
added for the catalog file. And added support for WildCat, RBBS and Doorsys
BBS's.
March 10, 1991: No release, but discovery of bugs when using WildCat or Gap BBS
software. Everything runs fine on PCBoard systems. Todd Miller & I are working
on this problem and hope to track it down soon.
April 6, 1991: v1.21: Fixed problem with multi-node *.cfg files and problem that
cropped up if the *.cfg file was named anything other than Orderdor.cfg.
April 7, 1991: v1.22: Added support for up to four (4) BBS Subscription fees.
April 27, 1991: v1.23: Added new utility to edit approval codes into the data
file for each transaction. I also got rid of the old external report utility and
have now included it within the door itself. It will now also give you the
option of printing all the data or only the new data since the last time a
report was printed. The CHARGE.DAT file format has now changed. Delete any old
.dat files (after printing a report of course) and create a new one.
May 21, 1991: v1.24: Added 4 more lines to the *.cfg file so that up to 4 credit
cards can be entered in so that OrderDoor will display the cards that your BBS
accepts (i.e. Visa, Mastercard, etc.) I also made a few cosmeteic changes to
both the door itself and the APPROVE.EXE utility.
August 3, 1991: v1.25: Fixed a couple of minor bugs that no one ever reported,
but that I had spotted. I also fixed a bug that occured using the ASCII SEARCH
function. If the user input an ENTER KEY, instead of some text, the routine
displayed the entire catalog file. (I can't believe I never caught that one
before now). I changed the file format of charge.dat again, so that I could
incorporate some of the changes in this version. The screen report function now
remembers what records you've already seen and only shows you any new records. I
also added a simple label printing routine, to print mailing labels from the
charge.dat file (my own idea!). I also added a LOG function. Now,
OrderDoor maintains a log file of all who enter the door. The filename
for this file is: Orderdor.log.
Thanks to the folowing SysOps who have either help test OrderDoor or have
provided valuable input into its development.
────────────────────────────────────────────────
Steve Stanfield, SysOp of Skyline BBS
Doug Carpenter, SysOp of PC Junction BBS
John McEntee, SysOp of The Blue Moon BBS
Gene Coleman, SysOp of The Silver Bullet BBS
Neil Pieman, SysOp of The Door BBS
Jeff Freeman, SysOp of The Front Porch
Bart Flint, SysOp of The Year 2000
and of course, last but not least.....
Todd Miller, SysOp of PC Technologies BBS.
Ordering Information:
────────────────────
OrderDoor may be ordered on-line at my BBS, PC Solutions of Cleveland via
OrderDoor, or you may mail a check, made payable to:
Southern Computer Systems, Inc.
2308 Guthrie Avenue
Cleveland, TN 37311
Attn: Premo Mondone
Once you've purchased OrderDoor, I'll upgrade your access on PC Solutions to
that of an OrderDoor Supporter and then you may download your registered version
and all subsequent versions from PC Solutions. When you log back-on you will be
given the filename to download and the password necessary to get the registered
version. PC Solutions is now a subscription BBS. If you are a subscriber AND an
OrderDoor registered user, then you will receive a lifetime subscription for the
cost of only a 1 year subscription ($20.00 per year).